<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Generic Access Profile (GAP).</title>
<link href="tabs.css" rel="stylesheet" type="text/css" />
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="alias.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="alias.js"></script>

<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>


<script type="text/javascript">
  jQuery(document).ready(function () {
    if(gref){ // Number all _img and _table classes
      gref();
    }
  });
</script>

</head>
<body>
<div id="top"><!-- do not remove this div! -->

<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  
  
  <td style="padding-left: 0.5em;">
   <div id="projectname">nRF51822 BLE SDK
   
   </div>
   
  </td>
  
  
  
 </tr>
 </tbody>
</table>
</div>

<!-- Generated by Doxygen 1.7.5 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
  initNavTree('group___b_l_e___g_a_p.html','');
</script>
<div id="doc-content">
<div class="header">
  <div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#groups">Modules</a> &#124;
<a href="#define-members">Defines</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">Generic Access Profile (GAP).</div>  </div>
<div class="ingroups"><a class="el" href="group__s110.html">S110 SoftDevice</a></div></div>
<div class="contents">

<p>Definitions and prototypes for the GAP interface.  
<a href="#details">More...</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Bluetooth Low Energy address.  <a href="structble__gap__addr__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP connection parameters.  <a href="structble__gap__conn__params__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__conn__sec__mode__t.html">ble_gap_conn_sec_mode_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP link requirements.  <a href="structble__gap__conn__sec__mode__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__conn__sec__t.html">ble_gap_conn_sec_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP connection security status.  <a href="structble__gap__conn__sec__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__irk__t.html">ble_gap_irk_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Identity Resolving Key.  <a href="structble__gap__irk__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__whitelist__t.html">ble_gap_whitelist_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">White list struct.  <a href="structble__gap__whitelist__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__adv__params__t.html">ble_gap_adv_params_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP advertising parameters.  <a href="structble__gap__adv__params__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__scan__params__t.html">ble_gap_scan_params_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP scanning parameters.  <a href="structble__gap__scan__params__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__sec__params__t.html">ble_gap_sec_params_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP security parameters.  <a href="structble__gap__sec__params__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__enc__info__t.html">ble_gap_enc_info_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP Encryption Information.  <a href="structble__gap__enc__info__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__master__id__t.html">ble_gap_master_id_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP Master Identification.  <a href="structble__gap__master__id__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__id__info__t.html">ble_gap_id_info_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP Identity Information.  <a href="structble__gap__id__info__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__sign__info__t.html">ble_gap_sign_info_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP Signing Information.  <a href="structble__gap__sign__info__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__adv__report__t.html">ble_gap_evt_adv_report_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for advertisement report event.  <a href="structble__gap__evt__adv__report__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__connected__t.html">ble_gap_evt_connected_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for connected event.  <a href="structble__gap__evt__connected__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__disconnected__t.html">ble_gap_evt_disconnected_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for disconnected event.  <a href="structble__gap__evt__disconnected__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__conn__param__update__t.html">ble_gap_evt_conn_param_update_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for connection parameter update event.  <a href="structble__gap__evt__conn__param__update__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__sec__params__request__t.html">ble_gap_evt_sec_params_request_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for security parameters request event.  <a href="structble__gap__evt__sec__params__request__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__sec__info__request__t.html">ble_gap_evt_sec_info_request_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for securito info request event.  <a href="structble__gap__evt__sec__info__request__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__passkey__display__t.html">ble_gap_evt_passkey_display_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for passkey display event.  <a href="structble__gap__evt__passkey__display__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__auth__key__request__t.html">ble_gap_evt_auth_key_request_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for authentication key request event.  <a href="structble__gap__evt__auth__key__request__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__sec__levels__t.html">ble_gap_sec_levels_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Security levels supported.  <a href="structble__gap__sec__levels__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__sec__keys__t.html">ble_gap_sec_keys_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Keys that have been exchanged.  <a href="structble__gap__sec__keys__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__auth__status__t.html">ble_gap_evt_auth_status_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for authentication status event.  <a href="structble__gap__evt__auth__status__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__conn__sec__update__t.html">ble_gap_evt_conn_sec_update_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for connection security update event.  <a href="structble__gap__evt__conn__sec__update__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__timeout__t.html">ble_gap_evt_timeout_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for timeout event.  <a href="structble__gap__evt__timeout__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__rssi__changed__t.html">ble_gap_evt_rssi_changed_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Event data for advertisement report event.  <a href="structble__gap__evt__rssi__changed__t.html#details">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structble__gap__evt__t.html">ble_gap_evt_t</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP event callback event structure.  <a href="structble__gap__evt__t.html#details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2><a name="groups"></a>
Modules</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___e_r_r_o_r_s___g_a_p.html">SVC return values specific to GAP.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___r_o_l_e_s.html">GAP Roles.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___t_i_m_e_o_u_t___t_y_p_e_s.html">GAP Timeout types</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_d_d_r___t_y_p_e_s.html">GAP Address types.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_d___t_y_p_e___d_e_f_i_n_i_t_i_o_n_s.html">GAP Advertising and Scan Response Data format.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_d_v___i_n_t_e_r_v_a_l_s.html">GAP Advertising interval max and min.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_d_v___t_y_p_e_s.html">GAP Advertising types.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_d_v___f_i_l_t_e_r___p_o_l_i_c_i_e_s.html">GAP Advertising filter policies.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_d_v___t_i_m_e_o_u_t___v_a_l_u_e_s.html">GAP Advertising timeout values.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___d_i_s_c___m_o_d_e_s.html">GAP Discovery modes.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___i_o___c_a_p_s.html">GAP IO Capabilities.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___a_u_t_h___k_e_y___t_y_p_e_s.html">GAP Authentication Key Types.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___s_e_c___s_t_a_t_u_s.html">GAP Security status.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___s_e_c___s_t_a_t_u_s___s_o_u_r_c_e_s.html">GAP Security status sources.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___c_p___l_i_m_i_t_s.html">GAP Connection Parameters Limits.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p___c_o_n_n___s_e_c___m_o_d_e___s_e_t___m_a_c_r_o_s.html">GAP attribute security requirement setters.</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___g_a_p___s_e_c___m_o_d_e_s.html">GAP Security Modes.</a></td></tr>
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga65d5382341d5a38c5a051ac7198ddb03"></a><!-- doxytag: member="BLE_GAP::BLE_GAP_ADDR_LEN" ref="ga65d5382341d5a38c5a051ac7198ddb03" args="" -->
#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga65d5382341d5a38c5a051ac7198ddb03">BLE_GAP_ADDR_LEN</a>&#160;&#160;&#160;6</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">BLE address length. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga6d6ae1b58ea2dc641e4dc30e8e2dcc0b"></a><!-- doxytag: member="BLE_GAP::BLE_GAP_ADV_MAX_SIZE" ref="ga6d6ae1b58ea2dc641e4dc30e8e2dcc0b" args="" -->
#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga6d6ae1b58ea2dc641e4dc30e8e2dcc0b">BLE_GAP_ADV_MAX_SIZE</a>&#160;&#160;&#160;31</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Maximum size of advertising data in octets. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gac2eb594dd57920a845941ba29990022d"></a><!-- doxytag: member="BLE_GAP::BLE_GAP_DEVNAME_MAX_LEN" ref="gac2eb594dd57920a845941ba29990022d" args="" -->
#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gac2eb594dd57920a845941ba29990022d">BLE_GAP_DEVNAME_MAX_LEN</a>&#160;&#160;&#160;20</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP device name maximum length. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gae54d6eefffc70a3ded9ebbede87e6a51"></a><!-- doxytag: member="BLE_GAP::BLE_GAP_SEC_KEY_LEN" ref="gae54d6eefffc70a3ded9ebbede87e6a51" args="" -->
#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gae54d6eefffc70a3ded9ebbede87e6a51">BLE_GAP_SEC_KEY_LEN</a>&#160;&#160;&#160;16</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP Security Key Length. <br/></td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom">{ <br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a313fb3d1fb123ab3eb11183530080590">SVC_BLE_GAP_ADDRESS_SET</a> =  BLE_GAP_SVC_BASE, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a037bc32d190f862e1cb41adae7013d02">SVC_BLE_GAP_ADDRESS_GET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a792241f639def89dc40dc5503c4f2ae0">SVC_BLE_GAP_ADV_DATA_SET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ab22135018306dd20c0e1cda4344d56e0">SVC_BLE_GAP_ADV_START</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388afcf97c9e4df93974c7c981da264cf591">SVC_BLE_GAP_ADV_STOP</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388abbc353cac52427644531fedb4decb613">SVC_BLE_GAP_SCAN_START</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388aab6587e43f9b598873b0449d5460b278">SVC_BLE_GAP_SCAN_STOP</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a47c8e8e10359119fa29f1a8a7a2564da">SVC_BLE_GAP_CONNECT</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a2b0a42a3288defd163ac7527f03b2cfb">SVC_BLE_GAP_CONNECT_CANCEL</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a215cd60fbc5f2c0a73892f1fedbb6f09">SVC_BLE_GAP_CONN_PARAM_UPDATE</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a74cf376ccf8351e0d610249f6a51973a">SVC_BLE_GAP_DISCONNECT</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a3474bf6d7a4463932a32273d2ebc2974">SVC_BLE_GAP_TX_POWER_SET</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a0a669a1117de62a62d8dead7022fd860">SVC_BLE_GAP_APPEARANCE_SET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a93075ab436906799527e861b38a4d7e7">SVC_BLE_GAP_APPEARANCE_GET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a7dad266415e81a1c4645af197d6787e3">SVC_BLE_GAP_PPCP_SET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ab95d8cfdfd3181fd39a657b1173ea7cf">SVC_BLE_GAP_PPCP_GET</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a1f819b01705c2d8ade78da44c76030cf">SVC_BLE_GAP_DEVICE_NAME_SET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ad5892689bd3ea0b6e838a418adc49ab5">SVC_BLE_GAP_DEVICE_NAME_GET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ac92325630b62ce381bb4a9b0f6c78754">SVC_BLE_GAP_AUTHENTICATE</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ab5d784f318769174494b39ab40f509d5">SVC_BLE_GAP_SEC_PARAMS_REPLY</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388acb306b447341b9b4724bf47d112e1984">SVC_BLE_GAP_AUTH_KEY_REPLY</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a2bcbc0d87a5899f52422477a890d7a1d">SVC_BLE_GAP_SEC_INFO_REPLY</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ac15ea2205b551c53a9325ef59d59c6e4">SVC_BLE_GAP_CONN_SEC_GET</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388a493a28e8f7fe2602e59381cf95ca9508">SVC_BLE_GAP_RSSI_START</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#gga385c44f6fb256e5716a2302a5b940388ab089183ea13ab23435a405610cab44cc">SVC_BLE_GAP_RSSI_STOP</a>
<br/>
 }</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP API SVC numbers.  <a href="group___b_l_e___g_a_p.html#ga385c44f6fb256e5716a2302a5b940388">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom">{ <br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da41ba498a9fda3e1cd345f4454a582bd9">BLE_GAP_EVT_ADV_REPORT</a> =  BLE_GAP_EVT_BASE, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035daa0b4789724d202a13a5e7eab85c52957">BLE_GAP_EVT_CONNECTED</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da057001bbd6ea9e615f19ef93cc0831ee">BLE_GAP_EVT_DISCONNECTED</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da9117fcf7efad580886dfad72e5d7cce7">BLE_GAP_EVT_CONN_PARAM_UPDATE</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da6c5eefbcfabbc1ce4a8bcbf550c285ae">BLE_GAP_EVT_SEC_PARAMS_REQUEST</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035daf1c60079f92820cb933ebdb66d2d8d7d">BLE_GAP_EVT_SEC_INFO_REQUEST</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035daedc549f5a6853a542bf93ff5d155292a">BLE_GAP_EVT_PASSKEY_DISPLAY</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da64d5d52e3ca8d8957bce011ad43d0f67">BLE_GAP_EVT_AUTH_KEY_REQUEST</a>, 
<br/>
&#160;&#160;<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da8958220152f7547da3b250b4f724877c">BLE_GAP_EVT_AUTH_STATUS</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da361bcc6098a88825333464335f6d22cc">BLE_GAP_EVT_CONN_SEC_UPDATE</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da57e5d1061d9b3d1500fb3556a3fb8847">BLE_GAP_EVT_TIMEOUT</a>, 
<a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da4d1c7d552ad87b09c53a4d4352fc91e6">BLE_GAP_EVT_RSSI_CHANGED</a>
<br/>
 }</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">GAP Event IDs. Those IDs uniquely identify an event coming from the stack to the application.  <a href="group___b_l_e___g_a_p.html#gabc5c98fcc1211af2b80116dd6e0a035d">More...</a><br/></td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga524b5d94f703242506d371cc56775967">ble_gap_address_set</a> (<a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> const *const p_addr)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Set local Bluetooth address.  <a href="#ga524b5d94f703242506d371cc56775967"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga98377d48567e98f371a1f73722dae312">ble_gap_address_get</a> (<a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> *const p_addr)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get local Bluetooth address.  <a href="#ga98377d48567e98f371a1f73722dae312"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga47c019be89deea8764244ff3b5f20184">ble_gap_adv_data_set</a> (uint8_t const *const p_data, uint8_t dlen, uint8_t const *const p_sr_data, uint8_t srdlen)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Set or update advertisement data fields.  <a href="#ga47c019be89deea8764244ff3b5f20184"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gabdbf78c3a8b09c6f2fb92d8733096af8">ble_gap_adv_start</a> (<a class="el" href="structble__gap__adv__params__t.html">ble_gap_adv_params_t</a> const *const p_adv_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Start advertising (GAP Discoverable, Connectable modes, Broadcast Procedure).  <a href="#gabdbf78c3a8b09c6f2fb92d8733096af8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga9c37d82f7855abd7417010d8a04c9718">ble_gap_adv_stop</a> (void)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Stop advertising (GAP Discoverable, Connectable modes, Broadcast Procedure).  <a href="#ga9c37d82f7855abd7417010d8a04c9718"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gaeaaa1b600b55399707f99e9e45ff4177">ble_gap_scan_start</a> (<a class="el" href="structble__gap__scan__params__t.html">ble_gap_scan_params_t</a> const *const p_scan_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Start scanning (GAP Discovery procedure, Observer Procedure).  <a href="#gaeaaa1b600b55399707f99e9e45ff4177"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga526e142f279fc74c535a51e77626c5f2">ble_gap_scan_stop</a> (void)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Stop scanning (GAP Discovery procedure, Observer Procedure).  <a href="#ga526e142f279fc74c535a51e77626c5f2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga760842d5b9840504f1be79387f376d90">ble_gap_connect</a> (<a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> const *const p_peer_addr, <a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> const *const p_conn_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a connection (GAP Link Establishment).  <a href="#ga760842d5b9840504f1be79387f376d90"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga37b68c3e73fecc8254972b9ce9c99797">ble_gap_connect_cancel</a> (<a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> const *const p_peer_addr)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Cancel a connection establishment.  <a href="#ga37b68c3e73fecc8254972b9ce9c99797"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga0f9c19bde4ab1e2f8a3a697908c91368">ble_gap_conn_param_update</a> (uint16_t conn_handle, <a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> const *const p_conn_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Update connection parameters.  <a href="#ga0f9c19bde4ab1e2f8a3a697908c91368"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga1b72b0bedcc2ff560582527aee8e6416">ble_gap_disconnect</a> (uint16_t conn_handle, uint8_t hci_status_code)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Disconnect (GAP Link Termination).  <a href="#ga1b72b0bedcc2ff560582527aee8e6416"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga99d6ed3853b41dba78dda05a51123986">ble_gap_tx_power_set</a> (int8_t tx_power)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Set the radio's transmit power.  <a href="#ga99d6ed3853b41dba78dda05a51123986"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga711f129fb97e0071ab04d2e994125f7a">ble_gap_appearance_set</a> (uint16_t appearance)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Set GAP Appearance field.  <a href="#ga711f129fb97e0071ab04d2e994125f7a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga29a7e84cb12d20e01e99d99ed1d3b5d1">ble_gap_appearance_get</a> (uint16_t *const p_appearance)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get GAP Appearance field.  <a href="#ga29a7e84cb12d20e01e99d99ed1d3b5d1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga28e0062141d77d7b2272fc3a6b6e17c5">ble_gap_ppcp_set</a> (<a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> const *const p_conn_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Set GAP Peripheral Preferred Connection Parameters.  <a href="#ga28e0062141d77d7b2272fc3a6b6e17c5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gafece35b7f8a4abcf297c18f1e947be1a">ble_gap_ppcp_get</a> (<a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> *const p_conn_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get GAP Peripheral Preferred Connection Parameters.  <a href="#gafece35b7f8a4abcf297c18f1e947be1a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga7d665aa56f8d248b8779a6cf170e2052">ble_gap_device_name_set</a> (<a class="el" href="structble__gap__conn__sec__mode__t.html">ble_gap_conn_sec_mode_t</a> const *const p_sec_mode, uint8_t const *const p_dev_name)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Set GAP device name.  <a href="#ga7d665aa56f8d248b8779a6cf170e2052"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gae257a1419d35e64dd029f29cd863ee84">ble_gap_device_name_get</a> (uint8_t *const p_dev_name, uint8_t *const p_len)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get GAP device name.  <a href="#gae257a1419d35e64dd029f29cd863ee84"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga3dda6bbc1387aecee1f9dde1e78f197d">ble_gap_authenticate</a> (uint16_t conn_handle, <a class="el" href="structble__gap__sec__params__t.html">ble_gap_sec_params_t</a> const *const p_sec_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Initiate GAP Authentication procedure.  <a href="#ga3dda6bbc1387aecee1f9dde1e78f197d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga5339c2562371354a0e3752b86214b92a">ble_gap_sec_params_reply</a> (uint16_t conn_handle, uint8_t sec_status, <a class="el" href="structble__gap__sec__params__t.html">ble_gap_sec_params_t</a> const *const p_sec_params)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Reply with GAP security parameters.  <a href="#ga5339c2562371354a0e3752b86214b92a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga70085abea4443877a5b8f33d130775b9">ble_gap_auth_key_reply</a> (uint16_t conn_handle, uint8_t key_type, uint8_t const *const key)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Reply with an authentication key.  <a href="#ga70085abea4443877a5b8f33d130775b9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga31de499e23c1d7876612af2fa65f3c46">ble_gap_sec_info_reply</a> (uint16_t conn_handle, <a class="el" href="structble__gap__enc__info__t.html">ble_gap_enc_info_t</a> const *const p_enc_info, <a class="el" href="structble__gap__sign__info__t.html">ble_gap_sign_info_t</a> const *const p_sign_info)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Reply with GAP security information.  <a href="#ga31de499e23c1d7876612af2fa65f3c46"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gacecf592516b7a6f84fafd77ae4d96478">ble_gap_conn_sec_get</a> (uint16_t conn_handle, <a class="el" href="structble__gap__conn__sec__t.html">ble_gap_conn_sec_t</a> *const p_conn_sec)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the current connection security.  <a href="#gacecf592516b7a6f84fafd77ae4d96478"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#gaaee3c336775cd4d40525684e3881d3b5">ble_gap_rssi_start</a> (uint16_t conn_handle)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Start reporting the received singnal strength to the application.  <a href="#gaaee3c336775cd4d40525684e3881d3b5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group___b_l_e___g_a_p.html#ga6bd5cc20040e31eef6a9e8992668bc98">ble_gap_rssi_stop</a> (uint16_t conn_handle)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Stop reporting the received singnal strength.  <a href="#ga6bd5cc20040e31eef6a9e8992668bc98"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>Definitions and prototypes for the GAP interface. </p>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="ga385c44f6fb256e5716a2302a5b940388"></a><!-- doxytag: member="ble_gap.h::@10" ref="ga385c44f6fb256e5716a2302a5b940388" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">anonymous enum</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>GAP API SVC numbers. </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a313fb3d1fb123ab3eb11183530080590"></a><!-- doxytag: member="SVC_BLE_GAP_ADDRESS_SET" ref="gga385c44f6fb256e5716a2302a5b940388a313fb3d1fb123ab3eb11183530080590" args="" -->SVC_BLE_GAP_ADDRESS_SET</em>&nbsp;</td><td>
<p>Set own Bluetooth Address. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a037bc32d190f862e1cb41adae7013d02"></a><!-- doxytag: member="SVC_BLE_GAP_ADDRESS_GET" ref="gga385c44f6fb256e5716a2302a5b940388a037bc32d190f862e1cb41adae7013d02" args="" -->SVC_BLE_GAP_ADDRESS_GET</em>&nbsp;</td><td>
<p>Get own Bluetooth Address. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a792241f639def89dc40dc5503c4f2ae0"></a><!-- doxytag: member="SVC_BLE_GAP_ADV_DATA_SET" ref="gga385c44f6fb256e5716a2302a5b940388a792241f639def89dc40dc5503c4f2ae0" args="" -->SVC_BLE_GAP_ADV_DATA_SET</em>&nbsp;</td><td>
<p>Set Advertisement Data. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ab22135018306dd20c0e1cda4344d56e0"></a><!-- doxytag: member="SVC_BLE_GAP_ADV_START" ref="gga385c44f6fb256e5716a2302a5b940388ab22135018306dd20c0e1cda4344d56e0" args="" -->SVC_BLE_GAP_ADV_START</em>&nbsp;</td><td>
<p>Start Advertising. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388afcf97c9e4df93974c7c981da264cf591"></a><!-- doxytag: member="SVC_BLE_GAP_ADV_STOP" ref="gga385c44f6fb256e5716a2302a5b940388afcf97c9e4df93974c7c981da264cf591" args="" -->SVC_BLE_GAP_ADV_STOP</em>&nbsp;</td><td>
<p>Stop Advertising. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388abbc353cac52427644531fedb4decb613"></a><!-- doxytag: member="SVC_BLE_GAP_SCAN_START" ref="gga385c44f6fb256e5716a2302a5b940388abbc353cac52427644531fedb4decb613" args="" -->SVC_BLE_GAP_SCAN_START</em>&nbsp;</td><td>
<p>Start Scanning. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388aab6587e43f9b598873b0449d5460b278"></a><!-- doxytag: member="SVC_BLE_GAP_SCAN_STOP" ref="gga385c44f6fb256e5716a2302a5b940388aab6587e43f9b598873b0449d5460b278" args="" -->SVC_BLE_GAP_SCAN_STOP</em>&nbsp;</td><td>
<p>Stop Scanning. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a47c8e8e10359119fa29f1a8a7a2564da"></a><!-- doxytag: member="SVC_BLE_GAP_CONNECT" ref="gga385c44f6fb256e5716a2302a5b940388a47c8e8e10359119fa29f1a8a7a2564da" args="" -->SVC_BLE_GAP_CONNECT</em>&nbsp;</td><td>
<p>Connect. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a2b0a42a3288defd163ac7527f03b2cfb"></a><!-- doxytag: member="SVC_BLE_GAP_CONNECT_CANCEL" ref="gga385c44f6fb256e5716a2302a5b940388a2b0a42a3288defd163ac7527f03b2cfb" args="" -->SVC_BLE_GAP_CONNECT_CANCEL</em>&nbsp;</td><td>
<p>Cancel ongoing connection procedure. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a215cd60fbc5f2c0a73892f1fedbb6f09"></a><!-- doxytag: member="SVC_BLE_GAP_CONN_PARAM_UPDATE" ref="gga385c44f6fb256e5716a2302a5b940388a215cd60fbc5f2c0a73892f1fedbb6f09" args="" -->SVC_BLE_GAP_CONN_PARAM_UPDATE</em>&nbsp;</td><td>
<p>Connection Parameter Update. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a74cf376ccf8351e0d610249f6a51973a"></a><!-- doxytag: member="SVC_BLE_GAP_DISCONNECT" ref="gga385c44f6fb256e5716a2302a5b940388a74cf376ccf8351e0d610249f6a51973a" args="" -->SVC_BLE_GAP_DISCONNECT</em>&nbsp;</td><td>
<p>Disconnect. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a3474bf6d7a4463932a32273d2ebc2974"></a><!-- doxytag: member="SVC_BLE_GAP_TX_POWER_SET" ref="gga385c44f6fb256e5716a2302a5b940388a3474bf6d7a4463932a32273d2ebc2974" args="" -->SVC_BLE_GAP_TX_POWER_SET</em>&nbsp;</td><td>
<p>Set TX Power. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a0a669a1117de62a62d8dead7022fd860"></a><!-- doxytag: member="SVC_BLE_GAP_APPEARANCE_SET" ref="gga385c44f6fb256e5716a2302a5b940388a0a669a1117de62a62d8dead7022fd860" args="" -->SVC_BLE_GAP_APPEARANCE_SET</em>&nbsp;</td><td>
<p>Set Appearance. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a93075ab436906799527e861b38a4d7e7"></a><!-- doxytag: member="SVC_BLE_GAP_APPEARANCE_GET" ref="gga385c44f6fb256e5716a2302a5b940388a93075ab436906799527e861b38a4d7e7" args="" -->SVC_BLE_GAP_APPEARANCE_GET</em>&nbsp;</td><td>
<p>Get Appearance. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a7dad266415e81a1c4645af197d6787e3"></a><!-- doxytag: member="SVC_BLE_GAP_PPCP_SET" ref="gga385c44f6fb256e5716a2302a5b940388a7dad266415e81a1c4645af197d6787e3" args="" -->SVC_BLE_GAP_PPCP_SET</em>&nbsp;</td><td>
<p>Set PPCP. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ab95d8cfdfd3181fd39a657b1173ea7cf"></a><!-- doxytag: member="SVC_BLE_GAP_PPCP_GET" ref="gga385c44f6fb256e5716a2302a5b940388ab95d8cfdfd3181fd39a657b1173ea7cf" args="" -->SVC_BLE_GAP_PPCP_GET</em>&nbsp;</td><td>
<p>Get PPCP. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a1f819b01705c2d8ade78da44c76030cf"></a><!-- doxytag: member="SVC_BLE_GAP_DEVICE_NAME_SET" ref="gga385c44f6fb256e5716a2302a5b940388a1f819b01705c2d8ade78da44c76030cf" args="" -->SVC_BLE_GAP_DEVICE_NAME_SET</em>&nbsp;</td><td>
<p>Set Device Name. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ad5892689bd3ea0b6e838a418adc49ab5"></a><!-- doxytag: member="SVC_BLE_GAP_DEVICE_NAME_GET" ref="gga385c44f6fb256e5716a2302a5b940388ad5892689bd3ea0b6e838a418adc49ab5" args="" -->SVC_BLE_GAP_DEVICE_NAME_GET</em>&nbsp;</td><td>
<p>Get Device Name. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ac92325630b62ce381bb4a9b0f6c78754"></a><!-- doxytag: member="SVC_BLE_GAP_AUTHENTICATE" ref="gga385c44f6fb256e5716a2302a5b940388ac92325630b62ce381bb4a9b0f6c78754" args="" -->SVC_BLE_GAP_AUTHENTICATE</em>&nbsp;</td><td>
<p>Initiate Pairing/Bonding. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ab5d784f318769174494b39ab40f509d5"></a><!-- doxytag: member="SVC_BLE_GAP_SEC_PARAMS_REPLY" ref="gga385c44f6fb256e5716a2302a5b940388ab5d784f318769174494b39ab40f509d5" args="" -->SVC_BLE_GAP_SEC_PARAMS_REPLY</em>&nbsp;</td><td>
<p>Reply with Security Parameters. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388acb306b447341b9b4724bf47d112e1984"></a><!-- doxytag: member="SVC_BLE_GAP_AUTH_KEY_REPLY" ref="gga385c44f6fb256e5716a2302a5b940388acb306b447341b9b4724bf47d112e1984" args="" -->SVC_BLE_GAP_AUTH_KEY_REPLY</em>&nbsp;</td><td>
<p>Reply with an authentication key. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a2bcbc0d87a5899f52422477a890d7a1d"></a><!-- doxytag: member="SVC_BLE_GAP_SEC_INFO_REPLY" ref="gga385c44f6fb256e5716a2302a5b940388a2bcbc0d87a5899f52422477a890d7a1d" args="" -->SVC_BLE_GAP_SEC_INFO_REPLY</em>&nbsp;</td><td>
<p>Reply with Security Information. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ac15ea2205b551c53a9325ef59d59c6e4"></a><!-- doxytag: member="SVC_BLE_GAP_CONN_SEC_GET" ref="gga385c44f6fb256e5716a2302a5b940388ac15ea2205b551c53a9325ef59d59c6e4" args="" -->SVC_BLE_GAP_CONN_SEC_GET</em>&nbsp;</td><td>
<p>Obtain connection security level. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388a493a28e8f7fe2602e59381cf95ca9508"></a><!-- doxytag: member="SVC_BLE_GAP_RSSI_START" ref="gga385c44f6fb256e5716a2302a5b940388a493a28e8f7fe2602e59381cf95ca9508" args="" -->SVC_BLE_GAP_RSSI_START</em>&nbsp;</td><td>
<p>Start reporting of changes in RSSI </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga385c44f6fb256e5716a2302a5b940388ab089183ea13ab23435a405610cab44cc"></a><!-- doxytag: member="SVC_BLE_GAP_RSSI_STOP" ref="gga385c44f6fb256e5716a2302a5b940388ab089183ea13ab23435a405610cab44cc" args="" -->SVC_BLE_GAP_RSSI_STOP</em>&nbsp;</td><td>
<p>Stop reporting of changes in RSSI </p>
</td></tr>
</table>
</dd>
</dl>

<p>Definition at line <a class="el" href="ble__gap_8h_source.html#l00023">23</a> of file <a class="el" href="ble__gap_8h_source.html">ble_gap.h</a>.</p>

</div>
</div>
<a class="anchor" id="gabc5c98fcc1211af2b80116dd6e0a035d"></a><!-- doxytag: member="ble_gap.h::@11" ref="gabc5c98fcc1211af2b80116dd6e0a035d" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">anonymous enum</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>GAP Event IDs. Those IDs uniquely identify an event coming from the stack to the application. </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da41ba498a9fda3e1cd345f4454a582bd9"></a><!-- doxytag: member="BLE_GAP_EVT_ADV_REPORT" ref="ggabc5c98fcc1211af2b80116dd6e0a035da41ba498a9fda3e1cd345f4454a582bd9" args="" -->BLE_GAP_EVT_ADV_REPORT</em>&nbsp;</td><td>
<p>Advertisement report. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035daa0b4789724d202a13a5e7eab85c52957"></a><!-- doxytag: member="BLE_GAP_EVT_CONNECTED" ref="ggabc5c98fcc1211af2b80116dd6e0a035daa0b4789724d202a13a5e7eab85c52957" args="" -->BLE_GAP_EVT_CONNECTED</em>&nbsp;</td><td>
<p>Connection established. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da057001bbd6ea9e615f19ef93cc0831ee"></a><!-- doxytag: member="BLE_GAP_EVT_DISCONNECTED" ref="ggabc5c98fcc1211af2b80116dd6e0a035da057001bbd6ea9e615f19ef93cc0831ee" args="" -->BLE_GAP_EVT_DISCONNECTED</em>&nbsp;</td><td>
<p>Disconnected from peer. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da9117fcf7efad580886dfad72e5d7cce7"></a><!-- doxytag: member="BLE_GAP_EVT_CONN_PARAM_UPDATE" ref="ggabc5c98fcc1211af2b80116dd6e0a035da9117fcf7efad580886dfad72e5d7cce7" args="" -->BLE_GAP_EVT_CONN_PARAM_UPDATE</em>&nbsp;</td><td>
<p>Connection Parameters updated. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da6c5eefbcfabbc1ce4a8bcbf550c285ae"></a><!-- doxytag: member="BLE_GAP_EVT_SEC_PARAMS_REQUEST" ref="ggabc5c98fcc1211af2b80116dd6e0a035da6c5eefbcfabbc1ce4a8bcbf550c285ae" args="" -->BLE_GAP_EVT_SEC_PARAMS_REQUEST</em>&nbsp;</td><td>
<p>Request to provide security parameters. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035daf1c60079f92820cb933ebdb66d2d8d7d"></a><!-- doxytag: member="BLE_GAP_EVT_SEC_INFO_REQUEST" ref="ggabc5c98fcc1211af2b80116dd6e0a035daf1c60079f92820cb933ebdb66d2d8d7d" args="" -->BLE_GAP_EVT_SEC_INFO_REQUEST</em>&nbsp;</td><td>
<p>Request to provide security information. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035daedc549f5a6853a542bf93ff5d155292a"></a><!-- doxytag: member="BLE_GAP_EVT_PASSKEY_DISPLAY" ref="ggabc5c98fcc1211af2b80116dd6e0a035daedc549f5a6853a542bf93ff5d155292a" args="" -->BLE_GAP_EVT_PASSKEY_DISPLAY</em>&nbsp;</td><td>
<p>Request to display a passkey to the user. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da64d5d52e3ca8d8957bce011ad43d0f67"></a><!-- doxytag: member="BLE_GAP_EVT_AUTH_KEY_REQUEST" ref="ggabc5c98fcc1211af2b80116dd6e0a035da64d5d52e3ca8d8957bce011ad43d0f67" args="" -->BLE_GAP_EVT_AUTH_KEY_REQUEST</em>&nbsp;</td><td>
<p>Request to provide an authentication key. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da8958220152f7547da3b250b4f724877c"></a><!-- doxytag: member="BLE_GAP_EVT_AUTH_STATUS" ref="ggabc5c98fcc1211af2b80116dd6e0a035da8958220152f7547da3b250b4f724877c" args="" -->BLE_GAP_EVT_AUTH_STATUS</em>&nbsp;</td><td>
<p>Authentication procedure completed with status. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da361bcc6098a88825333464335f6d22cc"></a><!-- doxytag: member="BLE_GAP_EVT_CONN_SEC_UPDATE" ref="ggabc5c98fcc1211af2b80116dd6e0a035da361bcc6098a88825333464335f6d22cc" args="" -->BLE_GAP_EVT_CONN_SEC_UPDATE</em>&nbsp;</td><td>
<p>Connection security updated. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da57e5d1061d9b3d1500fb3556a3fb8847"></a><!-- doxytag: member="BLE_GAP_EVT_TIMEOUT" ref="ggabc5c98fcc1211af2b80116dd6e0a035da57e5d1061d9b3d1500fb3556a3fb8847" args="" -->BLE_GAP_EVT_TIMEOUT</em>&nbsp;</td><td>
<p>Timeout expired. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabc5c98fcc1211af2b80116dd6e0a035da4d1c7d552ad87b09c53a4d4352fc91e6"></a><!-- doxytag: member="BLE_GAP_EVT_RSSI_CHANGED" ref="ggabc5c98fcc1211af2b80116dd6e0a035da4d1c7d552ad87b09c53a4d4352fc91e6" args="" -->BLE_GAP_EVT_RSSI_CHANGED</em>&nbsp;</td><td>
<p>Signal strength measurement report. </p>
</td></tr>
</table>
</dd>
</dl>

<p>Definition at line <a class="el" href="ble__gap_8h_source.html#l00389">389</a> of file <a class="el" href="ble__gap_8h_source.html">ble_gap.h</a>.</p>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga524b5d94f703242506d371cc56775967"></a><!-- doxytag: member="ble_gap.h::ble_gap_address_set" ref="ga524b5d94f703242506d371cc56775967" args="(ble_gap_addr_t const *const p_addr)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_address_set </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_addr</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set local Bluetooth address. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_addr</td><td>Pointer to address structure.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group___b_l_e___e_r_r_o_r_s___g_a_p.html#ga3eda228736d6c1dcbcf9aba2bd059068">BLE_ERROR_GAP_INVALID_BLE_ADDR</a> Invalid address. </dd></dl>

</div>
</div>
<a class="anchor" id="ga98377d48567e98f371a1f73722dae312"></a><!-- doxytag: member="ble_gap.h::ble_gap_address_get" ref="ga98377d48567e98f371a1f73722dae312" args="(ble_gap_addr_t *const p_addr)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_address_get </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> *const&#160;</td>
          <td class="paramname"><em>p_addr</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get local Bluetooth address. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[out]</td><td class="paramname">p_addr</td><td>Pointer to address structure.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga47c019be89deea8764244ff3b5f20184"></a><!-- doxytag: member="ble_gap.h::ble_gap_adv_data_set" ref="ga47c019be89deea8764244ff3b5f20184" args="(uint8_t const *const p_data, uint8_t dlen, uint8_t const *const p_sr_data, uint8_t srdlen)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_adv_data_set </td>
          <td>(</td>
          <td class="paramtype">uint8_t const *const&#160;</td>
          <td class="paramname"><em>p_data</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t&#160;</td>
          <td class="paramname"><em>dlen</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t const *const&#160;</td>
          <td class="paramname"><em>p_sr_data</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t&#160;</td>
          <td class="paramname"><em>srdlen</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set or update advertisement data fields. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>The format of the advertisement data will be checked by this call to ensure interoperability. Limitations imposed by this API call to the data provided include having a flags data type in the scan response data and duplicating the local name in the advertisement data and scan response data.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_data</td><td>Raw data to be placed in advertisement packet. If NULL, no changes are made to the current advertisement packet data. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">dlen</td><td>Data length for p_data. Max size: <a class="el" href="group___b_l_e___g_a_p.html#ga6d6ae1b58ea2dc641e4dc30e8e2dcc0b">BLE_GAP_ADV_MAX_SIZE</a> octets. Should be 0 if p_data is NULL, can be 0 if p_data is not NULL </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_sr_data</td><td>Raw data to be placed in scan response packet. If NULL, no changes are made to the current scan response packet data. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">srdlen</td><td>Data length for p_sr_data. Max size: <a class="el" href="group___b_l_e___g_a_p.html#ga6d6ae1b58ea2dc641e4dc30e8e2dcc0b">BLE_GAP_ADV_MAX_SIZE</a> octets. Should be 0 if p_sr_data is NULL, can be 0 if p_data is not NULL</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga10f61a8901fb865840da22a0792eca18">NRF_ERROR_INVALID_FLAGS</a> Invalid flag data type supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaca6d57e218563351e7abdbdebb049f69">NRF_ERROR_INVALID_DATA</a> Invalid data type(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga59fe2a8fe184005aefa0835c7ff400fd">NRF_ERROR_INVALID_LENGTH</a> Invalid data length(s) supplied. </dd>
<dd>
<a class="el" href="group___b_l_e___e_r_r_o_r_s___g_a_p.html#ga996146eb2c3b244f044b5cd121f8b826">BLE_ERROR_GAP_UUID_LIST_MISMATCH</a> Invalid UUID list supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="gabdbf78c3a8b09c6f2fb92d8733096af8"></a><!-- doxytag: member="ble_gap.h::ble_gap_adv_start" ref="gabdbf78c3a8b09c6f2fb92d8733096af8" args="(ble_gap_adv_params_t const *const p_adv_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_adv_start </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__adv__params__t.html">ble_gap_adv_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_adv_params</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Start advertising (GAP Discoverable, Connectable modes, Broadcast Procedure). </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_adv_params</td><td>Pointer to advertising parameters structure.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group___b_l_e___e_r_r_o_r_s___g_a_p.html#ga3eda228736d6c1dcbcf9aba2bd059068">BLE_ERROR_GAP_INVALID_BLE_ADDR</a> Invalid Bluetooth address supplied. </dd>
<dd>
<a class="el" href="group___b_l_e___e_r_r_o_r_s___g_a_p.html#gaa65c2f6a6eba52654e2b6febc5c3ba8c">BLE_ERROR_GAP_DISCOVERABLE_WITH_WHITELIST</a> Discoverable mode and whitelist incompatible. </dd></dl>

</div>
</div>
<a class="anchor" id="ga9c37d82f7855abd7417010d8a04c9718"></a><!-- doxytag: member="ble_gap.h::ble_gap_adv_stop" ref="ga9c37d82f7855abd7417010d8a04c9718" args="(void)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_adv_stop </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Stop advertising (GAP Discoverable, Connectable modes, Broadcast Procedure). </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd></dl>

</div>
</div>
<a class="anchor" id="gaeaaa1b600b55399707f99e9e45ff4177"></a><!-- doxytag: member="ble_gap.h::ble_gap_scan_start" ref="gaeaaa1b600b55399707f99e9e45ff4177" args="(ble_gap_scan_params_t const *const p_scan_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_scan_start </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__scan__params__t.html">ble_gap_scan_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_scan_params</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Start scanning (GAP Discovery procedure, Observer Procedure). </p>
<dl class="note"><dt><b>Note:</b></dt><dd>Not implemented, not valid in peripheral role.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_scan_params</td><td>Pointer to scan parameters structure. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NRF_ERROR_NOT_SUPPORTED. </dd></dl>

</div>
</div>
<a class="anchor" id="ga526e142f279fc74c535a51e77626c5f2"></a><!-- doxytag: member="ble_gap.h::ble_gap_scan_stop" ref="ga526e142f279fc74c535a51e77626c5f2" args="(void)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_scan_stop </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Stop scanning (GAP Discovery procedure, Observer Procedure). </p>
<dl class="note"><dt><b>Note:</b></dt><dd>Not implemented, not valid in peripheral role.</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NRF_ERROR_NOT_SUPPORTED </dd></dl>

</div>
</div>
<a class="anchor" id="ga760842d5b9840504f1be79387f376d90"></a><!-- doxytag: member="ble_gap.h::ble_gap_connect" ref="ga760842d5b9840504f1be79387f376d90" args="(ble_gap_addr_t const *const p_peer_addr, ble_gap_conn_params_t const *const p_conn_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_connect </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_peer_addr</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_conn_params</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Create a connection (GAP Link Establishment). </p>
<dl class="note"><dt><b>Note:</b></dt><dd>Not implemented, not valid in peripheral role.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_peer_addr</td><td>Pointer to peer address. If this is NULL, then the whitelist will be used to try to connect to one of the devices in it. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_conn_params</td><td>Pointer to desired connection parameters. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NRF_ERROR_NOT_SUPPORTED </dd></dl>

</div>
</div>
<a class="anchor" id="ga37b68c3e73fecc8254972b9ce9c99797"></a><!-- doxytag: member="ble_gap.h::ble_gap_connect_cancel" ref="ga37b68c3e73fecc8254972b9ce9c99797" args="(ble_gap_addr_t const *const p_peer_addr)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_connect_cancel </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__addr__t.html">ble_gap_addr_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_peer_addr</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Cancel a connection establishment. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>Not implemented, not valid in peripheral role.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_peer_addr</td><td>Pointer to peer address. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>NRF_ERROR_NOT_SUPPORTED. </dd></dl>

</div>
</div>
<a class="anchor" id="ga0f9c19bde4ab1e2f8a3a697908c91368"></a><!-- doxytag: member="ble_gap.h::ble_gap_conn_param_update" ref="ga0f9c19bde4ab1e2f8a3a697908c91368" args="(uint16_t conn_handle, ble_gap_conn_params_t const *const p_conn_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_conn_param_update </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_conn_params</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Update connection parameters. </p>
<p>If the central role this will initiate the connection parameter update, otherwise in the peripheral role, this will send the corresponding L2CAP request and wait for the central to perform the procedure. In both cases, and regardless of success or failure, the application will be informed of the result with a <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da9117fcf7efad580886dfad72e5d7cce7">BLE_GAP_EVT_CONN_PARAM_UPDATE</a> event.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_conn_params</td><td>Pointer to desired connection parameters. If NULL is provided on a peripheral role, the parameters in the PPCP characteristic of the GAP service will be used instead.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga5d2d8608f6d6a0329f58961a969e946e">NRF_ERROR_BUSY</a> Procedure already in progress. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga7ef4d466b79b31c6325f8b7af5d4f75f">NRF_ERROR_NO_MEM</a> Not enough memory to complete operation. </dd></dl>

</div>
</div>
<a class="anchor" id="ga1b72b0bedcc2ff560582527aee8e6416"></a><!-- doxytag: member="ble_gap.h::ble_gap_disconnect" ref="ga1b72b0bedcc2ff560582527aee8e6416" args="(uint16_t conn_handle, uint8_t hci_status_code)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_disconnect </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t&#160;</td>
          <td class="paramname"><em>hci_status_code</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Disconnect (GAP Link Termination). </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">hci_status_code</td><td>HCI status code, see <a class="el" href="group___b_l_e___h_c_i___s_t_a_t_u_s___c_o_d_e_s.html">Status codes specific to HCI</a>.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga99d6ed3853b41dba78dda05a51123986"></a><!-- doxytag: member="ble_gap.h::ble_gap_tx_power_set" ref="ga99d6ed3853b41dba78dda05a51123986" args="(int8_t tx_power)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_tx_power_set </td>
          <td>(</td>
          <td class="paramtype">int8_t&#160;</td>
          <td class="paramname"><em>tx_power</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set the radio's transmit power. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">tx_power</td><td>Radio transmint power in dBm (accepted values are -40, -20, -16, -12, -8, -4, 0, and 4 dBm).</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga711f129fb97e0071ab04d2e994125f7a"></a><!-- doxytag: member="ble_gap.h::ble_gap_appearance_set" ref="ga711f129fb97e0071ab04d2e994125f7a" args="(uint16_t appearance)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_appearance_set </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>appearance</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set GAP Appearance field. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">appearance</td><td>Appearance (16-bit), see <a class="el" href="group___b_l_e___a_p_p_e_a_r_a_n_c_e_s.html">Bluetooth Appearance values.</a>.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga29a7e84cb12d20e01e99d99ed1d3b5d1"></a><!-- doxytag: member="ble_gap.h::ble_gap_appearance_get" ref="ga29a7e84cb12d20e01e99d99ed1d3b5d1" args="(uint16_t *const p_appearance)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_appearance_get </td>
          <td>(</td>
          <td class="paramtype">uint16_t *const&#160;</td>
          <td class="paramname"><em>p_appearance</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get GAP Appearance field. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[out]</td><td class="paramname">p_appearance</td><td>Appearance (16-bit), see <a class="el" href="group___b_l_e___a_p_p_e_a_r_a_n_c_e_s.html">Bluetooth Appearance values.</a>.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga28e0062141d77d7b2272fc3a6b6e17c5"></a><!-- doxytag: member="ble_gap.h::ble_gap_ppcp_set" ref="ga28e0062141d77d7b2272fc3a6b6e17c5" args="(ble_gap_conn_params_t const *const p_conn_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_ppcp_set </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_conn_params</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set GAP Peripheral Preferred Connection Parameters. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_conn_params</td><td>Pointer to a PPCP structure with the desired parameters.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="gafece35b7f8a4abcf297c18f1e947be1a"></a><!-- doxytag: member="ble_gap.h::ble_gap_ppcp_get" ref="gafece35b7f8a4abcf297c18f1e947be1a" args="(ble_gap_conn_params_t *const p_conn_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_ppcp_get </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__conn__params__t.html">ble_gap_conn_params_t</a> *const&#160;</td>
          <td class="paramname"><em>p_conn_params</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get GAP Peripheral Preferred Connection Parameters. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[out]</td><td class="paramname">p_conn_params</td><td>Pointer to a PPCP structure where the parameters will be stored.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga7d665aa56f8d248b8779a6cf170e2052"></a><!-- doxytag: member="ble_gap.h::ble_gap_device_name_set" ref="ga7d665aa56f8d248b8779a6cf170e2052" args="(ble_gap_conn_sec_mode_t const *const p_sec_mode, uint8_t const *const p_dev_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_device_name_set </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structble__gap__conn__sec__mode__t.html">ble_gap_conn_sec_mode_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_sec_mode</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t const *const&#160;</td>
          <td class="paramname"><em>p_dev_name</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set GAP device name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_sec_mode</td><td>Write permissions for the Device Name characteristic see <a class="el" href="structble__gap__conn__sec__mode__t.html">ble_gap_conn_sec_mode_t</a>. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_dev_name</td><td>Pointer to an UTF8 string (NULL terminated).</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga4c61f2b54667506e90cc296721b2e658">NRF_ERROR_DATA_SIZE</a> Invalid data size(s) supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="gae257a1419d35e64dd029f29cd863ee84"></a><!-- doxytag: member="ble_gap.h::ble_gap_device_name_get" ref="gae257a1419d35e64dd029f29cd863ee84" args="(uint8_t *const p_dev_name, uint8_t *const p_len)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_device_name_get </td>
          <td>(</td>
          <td class="paramtype">uint8_t *const&#160;</td>
          <td class="paramname"><em>p_dev_name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t *const&#160;</td>
          <td class="paramname"><em>p_len</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get GAP device name. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">p_dev_name</td><td>Pointer to an empty buffer where the UTF8 string (NULL terminated) will be placed. </td></tr>
    <tr><td class="paramdir">[in,out]</td><td class="paramname">p_len</td><td>Length of the buffer pointed by p_dev_name, read bytes on output.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga4c61f2b54667506e90cc296721b2e658">NRF_ERROR_DATA_SIZE</a> Invalid data size(s) supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga3dda6bbc1387aecee1f9dde1e78f197d"></a><!-- doxytag: member="ble_gap.h::ble_gap_authenticate" ref="ga3dda6bbc1387aecee1f9dde1e78f197d" args="(uint16_t conn_handle, ble_gap_sec_params_t const *const p_sec_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_authenticate </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__sec__params__t.html">ble_gap_sec_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_sec_params</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Initiate GAP Authentication procedure. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_sec_params</td><td>Pointer to the security parameters to be used during the pairing procedure.</td></tr>
  </table>
  </dd>
</dl>
<p>In the central role, this function will send an SMP Pairing Request, otherwise in the peripheral role, an SMP Security Request will be sent. In the peripheral role, only the timeout, bond and mitm fields of <a class="el" href="structble__gap__sec__params__t.html">ble_gap_sec_params_t</a> are used.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>The GAP Authentication procedure may be triggered by the central without calling this function when accessing a secure service. </dd>
<dd>
Calling this function may result in the following events depending on the outcome and parameters: <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da6c5eefbcfabbc1ce4a8bcbf550c285ae">BLE_GAP_EVT_SEC_PARAMS_REQUEST</a>, <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035daf1c60079f92820cb933ebdb66d2d8d7d">BLE_GAP_EVT_SEC_INFO_REQUEST</a>, <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da64d5d52e3ca8d8957bce011ad43d0f67">BLE_GAP_EVT_AUTH_KEY_REQUEST</a>, <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da8958220152f7547da3b250b4f724877c">BLE_GAP_EVT_AUTH_STATUS</a>.</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga5339c2562371354a0e3752b86214b92a"></a><!-- doxytag: member="ble_gap.h::ble_gap_sec_params_reply" ref="ga5339c2562371354a0e3752b86214b92a" args="(uint16_t conn_handle, uint8_t sec_status, ble_gap_sec_params_t const *const p_sec_params)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_sec_params_reply </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t&#160;</td>
          <td class="paramname"><em>sec_status</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__sec__params__t.html">ble_gap_sec_params_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_sec_params</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Reply with GAP security parameters. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">sec_status</td><td>Security status, see <a class="el" href="group___b_l_e___g_a_p___s_e_c___s_t_a_t_u_s.html">GAP Security status.</a>. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_sec_params</td><td>Pointer to security parameters structure.</td></tr>
  </table>
  </dd>
</dl>
<p>This function is only used to reply to a <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da6c5eefbcfabbc1ce4a8bcbf550c285ae">BLE_GAP_EVT_SEC_PARAMS_REQUEST</a>, calling it at other times will result in an NRF_ERROR_INVALID_STATE. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>If the call returns an error code, the request is still pending, and the reply call may be repeated with corrected parameters.</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga70085abea4443877a5b8f33d130775b9"></a><!-- doxytag: member="ble_gap.h::ble_gap_auth_key_reply" ref="ga70085abea4443877a5b8f33d130775b9" args="(uint16_t conn_handle, uint8_t key_type, uint8_t const *const key)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_auth_key_reply </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t&#160;</td>
          <td class="paramname"><em>key_type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint8_t const *const&#160;</td>
          <td class="paramname"><em>key</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Reply with an authentication key. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">key_type</td><td>See <a class="el" href="group___b_l_e___g_a_p___a_u_t_h___k_e_y___t_y_p_e_s.html">GAP Authentication Key Types.</a>. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">key</td><td>If key type is BLE_GAP_AUTH_KEY_TYPE_NONE, then NULL. If key type is BLE_GAP_AUTH_KEY_TYPE_PASSKEY, then a 6-byte ASCII string (digit 0..9 only, no NULL termination). If key type is BLE_GAP_AUTH_KEY_TYPE_OOB, then a 16-byte OOB key value in Little Endian format.</td></tr>
  </table>
  </dd>
</dl>
<p>This function is only used to reply to a <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035da64d5d52e3ca8d8957bce011ad43d0f67">BLE_GAP_EVT_AUTH_KEY_REQUEST</a>, calling it at other times will result in an NRF_ERROR_INVALID_STATE. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>If the call returns an error code, the request is still pending, and the reply call may be repeated with corrected parameters.</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga31de499e23c1d7876612af2fa65f3c46"></a><!-- doxytag: member="ble_gap.h::ble_gap_sec_info_reply" ref="ga31de499e23c1d7876612af2fa65f3c46" args="(uint16_t conn_handle, ble_gap_enc_info_t const *const p_enc_info, ble_gap_sign_info_t const *const p_sign_info)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_sec_info_reply </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__enc__info__t.html">ble_gap_enc_info_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_enc_info</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__sign__info__t.html">ble_gap_sign_info_t</a> const *const&#160;</td>
          <td class="paramname"><em>p_sign_info</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Reply with GAP security information. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_enc_info</td><td>Pointer to Encryption Information structure. May be NULL to signal none is available. </td></tr>
    <tr><td class="paramdir">[in]</td><td class="paramname">p_sign_info</td><td>Pointer to Signing Information structure. May be NULL to signal none is available.</td></tr>
  </table>
  </dd>
</dl>
<p>This function is only used to reply to a <a class="el" href="group___b_l_e___g_a_p.html#ggabc5c98fcc1211af2b80116dd6e0a035daf1c60079f92820cb933ebdb66d2d8d7d">BLE_GAP_EVT_SEC_INFO_REQUEST</a>, calling it at other times will result in NRF_ERROR_INVALID_STATE. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>If the call returns an error code, the request is still pending, and the reply call may be repeated with corrected parameters.</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#ga0a5831cf5092e0dd43a01869676ee076">NRF_ERROR_INVALID_PARAM</a> Invalid parameter(s) supplied. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="gacecf592516b7a6f84fafd77ae4d96478"></a><!-- doxytag: member="ble_gap.h::ble_gap_conn_sec_get" ref="gacecf592516b7a6f84fafd77ae4d96478" args="(uint16_t conn_handle, ble_gap_conn_sec_t *const p_conn_sec)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_conn_sec_get </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structble__gap__conn__sec__t.html">ble_gap_conn_sec_t</a> *const&#160;</td>
          <td class="paramname"><em>p_conn_sec</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get the current connection security. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle. </td></tr>
    <tr><td class="paramdir">[out]</td><td class="paramname">p_conn_sec</td><td>Pointer to a Connection security structure.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gabc562e4ddfe2f427666a3acdd0b469a3">NRF_ERROR_INVALID_ADDR</a> Invalid pointer supplied. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="gaaee3c336775cd4d40525684e3881d3b5"></a><!-- doxytag: member="ble_gap.h::ble_gap_rssi_start" ref="gaaee3c336775cd4d40525684e3881d3b5" args="(uint16_t conn_handle)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_rssi_start </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Start reporting the received singnal strength to the application. </p>
<p>A new event is reported whenever the RSSI value changes, until ble_gap_rrsi_stop() is called.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
<a class="anchor" id="ga6bd5cc20040e31eef6a9e8992668bc98"></a><!-- doxytag: member="ble_gap.h::ble_gap_rssi_stop" ref="ga6bd5cc20040e31eef6a9e8992668bc98" args="(uint16_t conn_handle)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">uint32_t ble_gap_rssi_stop </td>
          <td>(</td>
          <td class="paramtype">uint16_t&#160;</td>
          <td class="paramname"><em>conn_handle</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Stop reporting the received singnal strength. </p>
<p>An RSSI change detected before the call but not yet received by the application may be reported after <a class="el" href="group___b_l_e___g_a_p.html#ga6bd5cc20040e31eef6a9e8992668bc98" title="Stop reporting the received singnal strength.">ble_gap_rssi_stop()</a> has been called.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramdir">[in]</td><td class="paramname">conn_handle</td><td>Connection handle.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="group__nrf__error.html#ga7e6367efeaac363d8cf024940b4ec123">NRF_SUCCESS</a> Success. </dd>
<dd>
<a class="el" href="group__nrf__error.html#gaf0aff2ba7864b34a36b4a96986e1851e">NRF_ERROR_INVALID_STATE</a> Invalid state to perform operation. </dd>
<dd>
<a class="el" href="group__ble__err.html#gabdc27cbc2ffac4a50640a0ce992c03af">BLE_ERROR_INVALID_CONN_HANDLE</a> Invalid connection handle supplied. </dd></dl>

</div>
</div>
</div>
</div>
  <div id="nav-path" class="navpath">
    <ul>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Defines</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>


    <li class="footer">
      Copyright &copy 2006-2011 <a href="http://www.nordicsemi.no" style="text-decoration:none">Nordic Semiconductor</a>.
      All Rights Reserved.
      <a href="disclaimer.html">Disclaimer</a>
    </li>
   </ul>
 </div>


</body>
</html>
